Расширение таблицы auth_db.error_directory кодами ошибок процесса обновления сессий (Refresh)

Выполнение инкрементальной SEED-миграции мастер-данных для добавления кодов компрометации и валидации токенов обновления из смежных спецификаций домена IAD.

Author

Services Task & Simulation Framework Documentation

Published

July 13, 2026

Краткая карточка задачи

DB-репозиторий: auth-service (База auth_db, контур SECURITY / Механизм ротации сессий).
Целевая СУБД: PostgreSQL v15+.
Ссылка на спецификацию: Спецификация GET /error-directory
Статус проекта: Готово к реализации

Ограничение публичной документации

В открытом доступе представлена демонстрационная версия задачи. В настоящей публичной документации отображены не все шаги, технические сценарии и приватные эндпоинты для системы цифровых симуляторов бизнес-процессов.

Полная спецификация метода: Доступна только во внутреннем контуре разработки (Confluence / Swagger Enterprise).
Для получения доступа: Обратитесь к системному аналитику или Product Owner вашей команды.

Инструкция по шагам: Выполнить финальную инкрементальную SEED-миграцию для наполнения общего реестра каноническими кодами ошибок, возникшими в результате проектирования и интеграции бизнес-логики фонового обновления сессий (Refresh Token Rotation). Новые записи должны расширить структуру справочника без изменения схемы данных, сохраняя строгий JSONB формат локализаций и UI-подсказок для корректной разморозки или сброса очереди интерцепторов мобильного клиента.

-- Финальный инкрементальный скрипт расширения справочника ошибок для контура Refresh и ротации сессий
INSERT INTO auth_db.error_directory (error_code, internal_status, message_translations, resolution_hint_translations)
VALUES 
(
    'ERR_REFRESH_TOKEN_EXPIRED', 
    'SESSION_REFRESH_TOKEN_COMPROMISED_OR_EXPIRED', 
    '{"ru": "Сессия авторизации полностью истекла или была аннулирована из соображений безопасности. Необходим повторный вход.", "en": "The authorization session has completely expired or has been revoked for security reasons. Re-login is required."}', 
    '{"ru": "Clear Flutter Secure Storage, disconnect WebSockets, and route user to Login Screen.", "en": "Clear Flutter Secure Storage, disconnect WebSockets, and route user to Login Screen."}'
),
(
    'ERR_VALIDATION_FAILED_REFRESH_MODEL', 
    'GATEWAY_FASTAPI_REFRESH_CONSTRAINTS_VIOLATION', 
    '{"ru": "Передан некорректный или пустой токен обновления refresh_token.", "en": "An invalid or empty refresh_token was provided in the request payload."}', 
    '{"ru": "Проверить длину и структуру передаваемой строки токена на фронтенде.", "en": "Check the length and constraints of the token string transmitted by the frontend."}'
)
ON CONFLICT (error_code) DO NOTHING;